HandStack 백엔드 기능 확장

첫 HandStack Function 만들기 (Node.js) (1/4)

2. 구조 확인 및 로직 구현

• featureMain.js는 Commands에 정의한 ID(예: GF01)를 키로 갖는 콜백 스타일 함수를 내보냅니다.

• 첫 번째 인자 callback(error, result)으로 결과를 반환하는 것이 Function의 실행 진입점입니다.

첫 HandStack Function 만들기 (Node.js) (2/4)

// Contracts/function/HDS/TST/JSF010/featureMain.js
module.exports = {
    GF01: (callback, moduleID, parameters, dataContext) => {
        // parameters: featureMeta.json Commands.Params로 전달된 값
        var serverName = $array.getValue(parameters, 'ServerName');

        var result = {
            DataTable1: [
                { FunctionResult: `Hello from Node.js Function! serverName: ${serverName}` }
            ]
        };

        callback(null, result);
    }

첫 HandStack Function 만들기 (Node.js) (3/4)

};

첫 HandStack Function 만들기 (Node.js) (4/4)

• 이 실습은 transact를 거쳐 호출합니다. function 실행 API에 대한 외부 접근은 별도 인증·네트워크 정책으로 제한합니다.

Function과 API 연동하기 (1/2)

Function을 거래로 노출하는 방법

• Function은 직접 URL을 갖지 않고, transact 거래 계약의 CommandType을 통해 노출됩니다.

• 클라이언트는 transact의 /transact/api/transaction/execute만 호출하고, transact가 CommandType=F인 거래를 function 모듈로 라우팅합니다.

Client ↔︎ transact (CommandType=F 라우팅) ↔︎ function

Function과 API 연동하기 (2/2)

transact/module.json의 RoutingCommandUri에 "HDS|*|F|D": ".../function/api/execution"처럼 등록되어 있어, 별도의 중계 컨트롤러 코드 없이 계약만으로 연동됩니다.

Function과 API 연동하기 (1/2)

실습: 거래 계약에서 Function 호출

• 거래의 TransactionID는 JSF010, ServiceID는 실제 함수 ID인 GF01과 대조합니다. 아래는 서비스 항목 일부입니다.

{
  "ServiceID": "GF01",
  "CommandType": "F",
  "ReturnType": "Json"
}

Function과 API 연동하기 (2/2)

• 핸즈온: Postman으로 POST /transact/api/transaction/execute 요청을 보내고 Function의 DataTable1 결과가 반환되는지 확인합니다.

연습: Function으로 간단한 로직 구현 (1/2)

1. PriceChecker Function 계약 만들기

• 상품 가격을 받아 특정 금액 이상이면 메시지를 로깅하는 Function을 만듭니다.

• Step 1: 계약 폴더 생성

Contracts/function/HDS/TST/PriceChecker/featureMeta.json
Contracts/function/HDS/TST/PriceChecker/featureMain.js

• Step 2: 로직 구현 (featureMain.js)

연습: Function으로 간단한 로직 구현 (2/2)

module.exports = {
  GF01: (callback, moduleID, parameters, dataContext) => {
    var price = Number($array.getValue(parameters, 'Price')) || 0;
    if (price >= 1000) {
      console.log(`[PriceChecker] 고가 상품 감지: ${price}원`);
    }

    callback(null, { DataTable1: [{ IsExpensive: price >= 1000 }] });
  }
};

연습: Function으로 간단한 로직 구현 (1/2)

2. 상품 생성 거래에 연동하기

• PriceChecker의 transact 계약을 먼저 작성합니다: TransactionID=PriceChecker, ServiceID=GF01, CommandType=F.

• dbclient XML의 <statement before="...">에 호출할 거래를 지정합니다. transact 서비스 JSON의 BeforeTransaction 필드가 아닙니다.

<!-- 기존 상품 저장 statement에 추가할 속성 예시 -->
<statement id="ID01" seq="0" before="HDS|TST|PriceChecker|GF01">
  <!-- 기존 param과 상품 INSERT SQL -->
</statement>

연습: Function으로 간단한 로직 구현 (2/2)

• 먼저 단독 호출을 확인한 뒤 저장 전에 연동합니다. Price 전달, 1000원 경계값, 호출 실패 시 저장 중단 여부를 로그와 후속 조회로 확인합니다.

• 전·후 거래 호출은 외부 부작용까지 원자적으로 롤백한다는 뜻이 아닙니다.